INSTALLATION OF CHROMIS POS WITH MYSQL OR MARIADB DATABASE. 


This is an alternative installation guide of Chromis POS on Linux. Note that there is an 
official installation guide published by Chromis: 

https://sourceforge.net/projects/chromispos/files/User%20Guides/Linux%20Installation 

%20-%20Guide.pdf/download 


Introduction. 

Operating System used: Linux, Debian Buster (testing). 

Desktop environment: KDE. 

The goal is to install Chromis POS and make it work with a MySQL / MariaDB database. 
We’ll also use Open JDK instead of the original java libraries from Oracle. 

Note: If you just want to install Chromis POS with a simple Derby database, skip section 1 
and go directly to section 2. Also, in section 3, choose ‘Derby’database engine when asked 
during the installation. When you start Chromis POS for the first time you’ll be asked to 
create a working database, then click on ‘Yes’. And that’s it. 
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1. INSTALLATION OF DATABASES 


Layers: 

3 rd layer: Graphical user interface: Phpmyadmin. 

2 nd layer: Database management system: MySQL, MariaDB. 

1 st layer: Database standard: SQL. 

I.A. Installation of mysql / mariadb and phpmyadmin packages with synaptic: 

Choose apache2 during the installation of the packages. 

You’ll be prompted to enter a password for the user ‘phpmyadmin’ 


EsSS" 

Jes Apply 

S Package 

i Installed Version 

Q, mysql 

Latest Version 

<3 

Description 

B (p akonadi-backend-mysql 

4:10.08.1-1 

4:18.08.1-1 

MySQL storage backend for Akonadi 

PI (p Iibqt4-sql-mysql 

4:4.8.7+dfsg-17 

4:4.8.7+dfsg-17 

Qt 4 MySQL database driver 

B (p phpmyadmin 

4:4.6.6-5 

4:4.6.6-5 

MySQL web administration tool 

CS (p mariadb-dient-10.1 

1:10.1.35-1 

1:10.1.35-1 

MariaDB database client binaries 

□ (P php-mysqf 

1:7.2+62 

1:7.2+62 

MySQL module for PHP [default] 

B (p libreoffice-base-drivers 

1:6.1.3~rcl-l 

1:6.1.3-rcl-l 

Database connectivity drivers for LibreOffice 

B (P rsyslog 

8.38.0-1+bl 

8.38.0-1+bl 

reliable system and kernel logging daemon 

1 1 (p php7.2-mysql 

7.2.9-1 

7.2.9-1 

MySQL module for PHP 

□ (p libqtSsqlS-mysql 

5.11.2+dfsg-3 

5.11.2+dfsg-3 

Qt 5 MySQL database driver 

B (P mysql-common 

5.8+1.0.4 

5.8+1.0.4 

MySQL database common files, e.g. /etc/mysq 

B (p libdbd-mysql-perl 

4.048-1 

4.048-1 

Perl5 database interface to the MariaDB/MySQ 

B (P dbconfig-common 

2.0.10 

2.0.10 

framework that helps packages to manage dal 

B (P dbconfig-mysql 

2.0.10 

2.0.10 

dbconfig-common MySQb/MariaDB support 

B (P Itbdbi-perl 

1.641-1 

1.641-1 

Perl Database Interface (DBI) 

□ P librdfO 

1.0.17-1.1 

1.0.17-1.1 

Redland Resource Description Framework (RDF 

C5 (p default-mysql-client 

1.0.4 

1.0.4 

MySQL database client binaries (metapackage 

□ £p default-mysql-client-core 

1.0.4 

1.0.4 

MySQL database core client binaries (metapac 

B (P default-mysql-server 

1.0.4 

1.0.4 

MySQL database server binaries and system d 

B (P default-mysql-server-core 

1.0.4 

1.0.4 

MySQL database server binaries (metapackagi 













Jes Apply 


Q, mariadb] 

<3 

S Package 

Installed Version 

Latest Version 

Description 

PI (P phpmyadmin 

4:4.6.6-5 

4:4.6.6-5 

MySQL web administration tool 

□ (P MbmariadbclientlO 

1:10.1.35-1 

1:10.1.35-1 

MariaDB database client library 

E (P mariadb-dient-10.1 

1:10.1.35-1 

1:10.1.35-1 

MariaDB database client binaries 

□ (P mariadb-cIient-core-10.1 

1:10.1.35-1 

1:10.1.35-1 

MariaDB database core client binaries 

H (P mariadb-common 

1:10.1.35-1 

1:10.1.35-1 

MariaDB common metapackage 

H (p mariadb-server-10.1 

1:10.1.35-1 

1:10.1.35-1 

MariaDB database server binaries 

□ (p mariadb-server-core-10.1 

1:10.1.35-1 

1:10.1.35-1 

MariaDB database core server files 

□ (P libdbd-mysql-perl 

4.040-1 

4.040-1 

PerlS database interface to the MariaDB/MySQL 

PI (P dbconfig-common 

2.0.10 

2.0.10 

framework that helps packages to manage dat 

□ (P dbconfig-mysql 

2.0.10 

2.0.10 

dbconfig-common MySQU/MariaDB support 


I.B. Reboot and run ‘my^ql-Secure-installation’ 

The program mysql_secure_installation allows to configure MySQL/MariaDB in order to 
improve its security. 

Running mysql_secure_installation 


sudo mysql_secure_installation 
password: (Enteryour linux password) 

Enter current password for root (enter for none): (Press enter. Note that this 
is the root user of the database) 

Set root password? [Y/n] y 
New password: (Write a password) 

Remove anonymous users? [Y/n] y 
Disallow root login remotely? [Y/n] y 
Remove test database and access to it? [Y/n] y 
Reload privilege tables now? [Y/n] y 


More on mysql_secure_installation: 

https://mariadb.com/kb/en/library/mysql secure installation/ 


l.C. Basic commands. 

In order to be able to log in to mysql/mariadb as root user, open the terminal and run: 
sudo mysql -h localhost -u root -p 

First you have to enter your password on Linux. And after that you have to enter the 
password you have set for the root user of the database. 

This is the shell: 

MariaDB[(none)]> 


When you want to exit: 

MariaDB [mysql]> exit; 
Bye 


Some basic commands to start/stop mysql and apache2 servers: 

MYSQL SERVER 

sudo service mysql start 
sudo service mysql stop 
sudo service mysql restart 

APACHE2 SERVER 

sudo service apache2 start 
sudo service apache2 stop 
sudo service apache2 restart 






I.D. When you try to log in to phpmyadmin using the user ‘root’ you may get this error 
message: 1698 - Access denied for user 'root'(©'localhost' 

You may solve this problem by granting privileges to the user ‘phpmyadmin’. So at 

least you can log in to phpmyadmin with the user ‘phpmyadmin’ and perform administrative 
tasks (create databases, etc). In order to do this follow these steps: 


Open the terminal and run this command: 
sudo mysql -h localhost -u root -p 

First enter your password on Linux. And after that enter the password you’ve set for the root 
user of the database. 

After that, proceed with this: 

MariaDB [(none)]>SELECT User, Host, plugin FROM mysql.user; 


+ - + - + - + 


User 

Host 

plugin 

root 

localhost 

unix_socket 

phpmyadmin 

localhost 



As you can see in this example, there are 2 users of the database, root and phpmyadmin. 
Let’s grant administrative privileges to the phpmyadmin user: 


MariaDB [(none)]>GRANT ALL PRIVILEGES ON *.* TO 'phpmyadmin '§ 'localhost'; 
MariaDB [(none)]>FLUSH PRIVILEGES; 

MariaDB [(none)]>exit; 


More on the GRANT command: https://mariadb.com/kb/en/library/grant/ 


Now you can log in to phpmyadmin with the user 'phpmyadmin' with administrative 
privileges (you can create databases, etc) 


phpMyAdmln 


Welcome to phpMyAdmin 



l.E. Creation of database for Chromis POS. 

Log in to phpmyadmin and create a database called ‘chromispos’. 


it (j) localhost.‘phpmyadmin;'S 0rver_dji:£ibJEC£.php : I db-&iQkcn-d2i:- r r-- ( .: , d2/co r i:.2c2ji:-i:-jb91f-/2lf-i:- f 44 t jd 

I ijl Server, [oca I host:3306 


I e o. s 


phpMyAdmin 

nt a # 0 ifli $ 

Recent Favorites 


_ 0 New 

+ _ chromispos 
+ - , informationschema 
+ _ mysql 

+ _ performance_5chema 
+ _ phpmyadmin 


(j Databases SQL Status L li User accounts § Export @ Import jr 7 Setting 


Databases 


Create database <g$ 

Database name 


Collation Action 


H chromispos 


1 1 fflnh4_genera L_e i ,b=| Check privileges 







































2. INSTALLATION OF JAVA LIBRARIES 


Make sure ‘openjdk’ and other libraries are installed. You’ll probably have to install the 
‘icedtea’ plugin as well. In principle, this could be enough to make Chromis POS work. 


Jes Apply 


openjdk| 

€1 | 

S Package 

Installed Version 

Latest Version 

Description 

□ (p default-jre 

2:1.10-68 

2:1.10-68 

Standard Java or Java compatibl e Runtime 

□ CP default-jre-headless 

2:1.10-68 

2:1.10-68 

Standard Java or Java compatible Runtime ( 

■ (P libreoffice 

l:6.1.3~rcl-l 

l:6.1.3~rcl-l 

office productivity suite (metapackage) 

0 (P openjdk-10-jre 

10.0.2+13-1 

10.0.2+13-2 

OpenJDKJava runtime, using Hotspot JIT 

0 (P openjdk-10-jre-headless 

10.0.2+13-1 

10.0.2+13-2 

OpenJDKJava runtime, using Hotspot JIT (he 

□ (P openjdk-8-jre 

8ul71-bll-2 

8ul71-bll-2 

OpenJDKJava runtime, using Hotspot JIT 

□ (P openjdk-8-jre-headless 

8ul71-bll-2 

8ul71-bll-2 

OpenJDKJava runtime, using Hotspot JIT (he 

□ (P icedtea-8-plugin 

1.6.2-3.1 

1.6.2-3.1 

web browser plugin based on OpenJDK and 


es Apply 

S Package 

| (P openjdk-8-jre 

■ (p openjdk-8-jre-headless 

□ (P icedtea-8-plugin 

■ (P icedtea-netx 

□ (P icedtea-netx-common 


icedtea| 


Installed Version Latest Version Description 


8ul71-bll-2 
8ul71-bll-2 
1.6.2-3.1 


8ul71-bll-2 
8ul71-bll-2 
1.6.2-3.1 


OpenJDKJava runti me, using Hotspot JIT 
OpenJDKJava runtime, using Hotspot JIT (he 
web browser plugin based on OpenJDK and I 
NetX - implementation of the Java Network 
NetX - implementation of the Java Network 


However, if you prefer java libraries from Oracle, you have to remove ‘openjdk’ and 
‘icedtea’ packages and install the java libraries from Oracle. In order to install java from 
Oracle, please read the installation manual published by Chromis: 

https://sourceforge.net/projects/chromispos/files/User%20Guides/Linux%20Installation 

%20-%20Guide.pdf/download 


3. EXECUTION OF CHROMIS POS INSTALLER. 


• Download the Chromis POS installer. 

https://sourceforge.net/projects/chromispos/files/Linux/ 


• Go to the the folder where the installer was downloaded and make the installation file 
executable: 

Select the file -► Properties ->■ Permissions -► Executable. 

• Open the terminal. Go to the folder where you put the installation file and execute the 
installer. For example, if the name of the installer is ‘chromispos-0.58.5.7a-linux- 
x64-installer. run' and you put the installation file in the Downloads folder: 


cd Downloads 

sudo ./chromispos-0.58.5.7a-linux-x64-installer.run 


• You’ll be asked to select the installation folder and the database engine: 

Installation directory: /opt/chromispos 

Database engine: mysql 
Finish the installer. 

• You can directly start now chromis pos by clicking on opt/chromispos/start.sh 

However, you might want to execute it from your application launcher. This is how to do it 
if you are using KDE: 

Right-click on the KDE launcher -► Edit applications -► New item 
Name: ‘Chromis POS’ 

Command: /opt/chromispos/start.sh 
Work path: /opt/chromispos/ 

You can also select an icon. You can select the icon located at: /opt/chromispos/pos.ico 
Save the changes. 


General Advanced 


Name: 


Description: Chromis POS 


Chromis POS 


Comment: Chromis POS 


Command: /opt/chromispos/start.sh 


8 Enable launch feedback 
Q Only show in KDE 










4. DATABASE SETUP 


• Start Chromis POS. 

You’ll probably get this first message: “A working dadabase cannot be detected. A default 
database will be created. Do you want to continue?” 

Select ‘Yes’. The program will create a Derby database and start. A derby database should 
be more than enough for a small business. However, we are trying to use MySQL now. 

• As an administrator, Go to configuration and change it: 

Database: MySQL 

Driver Library: /opt/chromispos/./lib/mysql-connector-java-5.1.26-bin.jar 
Driver Class: com.mysql.jdbc.Driver 
URL: jdbc:mysql://localhost:3306/chromispos 
User: phpmyadmin 

Password: (enter the password for phpmyadmin) 

Click on ‘test’ to make sure there is a valid connection with the database. 

If successful, you’ll get the message: “You are connected! Restart Chromis POS to load 
your database connection”. 

Click on ‘Save’ and restart the program. 
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_ n x 

The Default database shipped with Chrorr 
It is intended for stand-alone, single-user. 
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to connect Chromis POS 
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i ok 
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Chromis Web site 




1 


debian95test - General 
jdbc:mysql://localhost:3306/chromispos 


Administrator 


Once you restart Chromis POS again you may get the same error message about ‘no 
database’. Then click on ‘Yes’ anyway. If you go to configuration, the MySQL configuration 
you set before will probably be there. Restart the program again and you shouldn’t get more 
starting errors and you should be able to use the MySQL database. 


Final note: If you need to uninstall chromis pos, then run these commands: 


cd /opt/chromispos 
sudo ./uninstall 


Ed. 06-11-2018 



by Icavot 
























































